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RESOURCE MANAGEMENT SYSTEM 

Datapoint’s Resource Management System™ (RMS) operating system provides increased efficiency, flexibili¬ 
ty;, and security for both stand-alone and Attached Resource Computer™ (ARC™) systems. Supporting multiple 
users, multiple languages, and multiple functions, RMS operates in both shared logic and multiprocessing en¬ 
vironments. 

Through dynamic resource sharing, RMS makes optimum use of all system components including processors, 
memory, disk storage, peripherals, and communications facilities. 

This dynamic sharing is provided through a unique approach to resource and file management. Every time a 
user signs on to RMS, a new operating environment is created-custom tailored to his needs. 

This RMS Quick Reference Guide provides a quick overview of the signing on, environment establishing, and 
logging off procedures, along with a short explanation of available utilities. 



Signing On to RMS 


The RMS SIGNON program may be activated by entering a special key sequence from an inactive workstation 


as follows: 



SIGNON 


Establishing Environments 

• nmpnts must always be present in the User Environment Table (UET): 

Three environments must aiw<*y» h rreated bv 

The Working Environment which is used to hold temporary work hies created by 

user programs. 

Th. O.M..V Environment which is need to hold system utilities or other programs 
accessible to all users. 

=t tisssss ass ,oca 


:W 


:U 


environments 




Following SIGNON, the user must define the WORKING (:W) and UTILITY (:U) environments. These prompts 
will not be displayed if a STARTUP file is used to automatically establish these two environments. Prompts 
appear as: 


WORKING (:W) ENVIRONMENT 
NET NAME: 

NODE NAME: 

DISK NAME: 

CATALOG: 

PASSWORD: 

UTILITY (:U) ENVIRONMENT 
NET NAME: 

NODE NAME: 

DISK NAME: 

CATALOG: 

PASSWORD: 


ENVIRONMENTS 


where 

NET 

NODE 
DISK NAME 

CATALOG 

PASSWORD 


„ th . came of... actual ARC system ■».»<>*<*» 
access. 

is the symbolic name for the processor on which the user wishes to run RMS. 

is the symbolic name of the multifile resource where the catalog for the env.ron- 
ment being defined resides. 


is the Hierarchical Structure Information (HSI) of the catalog file to be accessed, 
functions as the security key. 


ENVIRONMENTS 



LOGGING OFF 


To exit from RMS, the workstation operator should log off by entering the following special key sequence from 
the appropriate ACTIVE workstation: 



*Blank key above NEW LINE key LOGOFF 


RMS UTILITIES 

RMS provides a apprehensive ass 

section^howsa prototypeTOrnrnanc^nne, illustrating the general format of the command along with a 
planation of the fields on the command line. . refer to 


UTILITIES 



STANDARD NOTATIONS AND GENERIC SYMBOLS 


< field > 


[option] 
ALL CAPS 


lower case 


+ 


? 


A field in corner brackets indicates a replacement field. When the command is ac¬ 
tually entered, some string will replace the name within the brackets. For exam¬ 
ple, <filename> might be replaced by INFILE. 

Square brackets enclose optional fields. Keywords, such as IN = , are not re¬ 
quired if files are listed positionally. 

Words or letters appearing as upper case are to be entered exactly as they ap¬ 
pear. 

Words or letters in lower case indicate that a value should be entered in their 
place. 

The plus sign indicates that any combination of characters will be accepted from 
the + to the end of the name in a filename, extension, or environment. 

The question mark indicates that any one character, except a blank, will be ac¬ 
cepted in that position in a filename or extension. 

The negation character indicates that any one character, except a blank or the 
character following it, will be accepted in that position in a filename or extension. 




• BACKUP 

• BACKUP9301 

• BJF 

• BUILD 

• CAT 

• CHANGE 

• CHAREDIT 

• CONFIG 


• COPY 

• CREATE 

• CTFORMAT 

• DCTAPE 

• DELETE 

• DUMP 

• EDIT 

• ENCODE 


• ENV 

• ERRLOG 

• FMS 

• GETARC 

• GETDOS 

• INDEX 

• INFO 

• LIB 


• LINK 

• LIST 

• LOG 

• MINIDOS 

• NQDQ 

• PACKGEN 

• PCR 

• PUTARC 


• PUTDOS 

• REFORMAT 

• RENAME 

• REPAIR 

• SECURE 

• SORT 

• STARTUP 

• TAPEUTIL 


. , BMS . HELP option wh.ch cause, the dlsp.ay o. command line syntax and options. The ton 

5 o?“hB HELP o5?”n is illustrated In the tollowlnp example: 


< utility name>;HELP 


UTILITIES 



BACKUP-CATALOG MODE 


The BACKUP utility allows the user to back up part or all of a disk’s catalogs, including subordinate catalogs 
and files, onto one or more disks. BACKUP operates in three modes: catalog mode, serial mode, and restore 
mode, each of which uses a slightly different command line. 

BACKUP in catalog mode backs up user-specified catalogs. 

BACKUP :<env 1 >,:<env 2>[,<filespec>] [;<options>] 
where 


<env 1 > is the input environment specification which identifies the disk resource and the 

catalog level to be backed up. 

<env 2> is the output environment specification that identifies the disk resource and the 

catalog level to receive the backup. 

<filespec> is the workfile specification used by BACKUP. 

Refer to the BACKUP options (page 14) for a description of those that may be used in this mode. 


BACKUP in serial mode copies catalogs too large to fit on the backup disk into one or mor. specially formattad 
serial output files so they can be backed up on multiple disks. 


BACKUP :<env> 


,<filespec 1 >[,<filespec 2>];SERIAL[,<options>] 


where 


<env> 

<filespec 1> 
<filespec 2> 

Refer to the BACKUP options 


is the input environment specification. 

is the specification for the first serial output file to receive the input files, 
is the work file specification. 

for a description of those that may be used in this mode. 


BACKUP-SERIAL MODE 



backup , BACKUP-RESTORE MODE 

BACKUP operates ,n RESTORE mo* to restore tt.ee Boctteu up to eerta, ™* to ttt.i, ort.tnru to,™,. 
ACKUP <filespec 1 >,:<env>[,<fiiespec 2>];RESTORE[,<options>] 
where 


<filespec 1 > 


seria?mode. ^ speci,ication of th « «rst (and 


possibly only) file generated by 


<env> 

<filespec 2> 

Refer to the BACKUP options 


is the output environment specification, 
is the work file specification. 

for a description of those that may be used in this mode. 


The BACKUP utility allows the following options: 

SERIAL - backs up disk data to one or more serial output files; this output must then be 

RESTOREd. 


RESTORE - 
INCLUDE - 
EXCLUDE - 
OVERWRIT 
BYPASS - 
SKI PN EXT - 
RESTART - 


restores data backed up in serial mode to its original format, 
specifies generically or specifically the files to be RESTOREd. 
specifies generically or specifically files that are not to be RESTOREd. 
in any mode, overwrites existing output files, 
in any mode, bypasses backing up a file that cannot be accessed, 
in any mode, bypasses backing up or restoring a file that has an error, 
restarts the current mode operation at the point of last failure. 


BACKUP-OPTIONS 



BACKUP9301 UTILITY 

BACKUP9301 is a utility program designed for Datapoint’s 8630 system (an 8600 processor with the 9301 

^ S mnfiJ e | SUb f ySte r t0 provid ? for mirror 'mage backup copy from disk to tape or tape to disk. BACKUP9301 is 
completely interactive, prompting you for the specifications for any operation. 

BACKUP9301;[< option >] 

The only option available is the HELP option. 


Build is used to combine records from various user-specified text files to create a new text file. BUILD allows 
you to create text files from any combination of three inputs: 

1) New records entered from the keyboard 

2) Records copied from existing files 

3) Complete files that are appended to the output 

BUILD [OUT = ]<filespec 1 >[,WSIN = ]<filespec 2>] 

[,WSOUT = ]<filespec 3>] [;<options>] 

where 

[OUT = ]<filespec 1 > is the specifications for the output file being created. 

[WSIN =]<filespec 2> is the specification for a user-created command file containing the directives 

BUILD is to execute. 

[WSOUT = ]<filespec 3> is the specification for a workstation Output file for BUILD messages; otherwise, 

messages default to the screen. 


BUILD UTILITY 



BUILD-OPTIONS 


BUILD provides the following options for environment control: 

APP - directs BUILD to append the new data to the output file. 

MAXREC = < n > - must be used when the largest record size in the file exceeds 256 bytes; specify 

1, 2, 3, or 4 representing multiples of 1024 bytes. 

The BUILD command uses the following directives: 

- build new text file from records entered through the keyboard. 

- used before COPY, DISPLAY, or SKIP to open an input file. 

- used to copy, display, or skip records from a specified input file. 

- used to specify records for COPY, DISPLAY, SKIP. 

- terminates BUILD. 


ENTER 

OPEN 

COPY 1 
DISPLAY 
SKIP J 

TO, UNTIL, 
FIRST, NEXT, 
LAST 

END | * 


The Batched Job Facility (BJF) is a multi-utility package that provides the capability to schedule, execute, and 
print jobs in unattended mode. BJF can be combined with networking to provide a remote job processing facility. 

Those utilities comprising BJF are: 

BJF - initializes or restarts the Central Controller. 

EXECUTE - creates an executor that processes CHAIN requests. 

UNSPOOL - controls up to four printers and handles all print requests. 

SUBMIT - submits requests to execute CHAIN files. 

SPOOL - submits requests to unspool print files. 

CONNECT - allows a CHAIN being run at an executor to communicate with the Central Con¬ 

troller. 

CONSOLE - allows the user to interactively monitor and control BJF activity; requires the use 

of a workstation. 


BJF UTILITIES 



BJF-BJF 


BJF [<filespeo] [,<:env1 >] [,:<env2>] [;<options>] 
where 

<filespeo names the configuration file to be used by BJF. 

cenv 1 > specifies the environment for the Central Control File, 

cenv 2> specifies the environment for the Central log file. 

BJF has the following options: 

CREATE - indicates that all BJF system disk files are to be created and intialized. 

INDEP - causes the Central Controller to run as an independent task. 

LOG = <nnn> - specifies the log file suffix; defaults to 001. 


EXECUTE [cconfig file>] [;<options>] where 

cconfig file> names the configuration file to be used by EXECUTE. 

EXECUTE options: 

NOCONFIG - causes EXECUTE to prompt for initialization data otherwise provided by the con¬ 

figuration files. 

PUP . deletes any existing executor with the same node name and taskname. 

The UNSPOOOL command line is: 


UNSPOOL [<config file>] 
where 

< config file> specifies the configuration file that contains, for each of the four possible printer 

tasks, information such as printer name, class, type, form name, state descrip¬ 
tion, buffers, password, and burst information. 

BJF - EXECUTE/UNSPOOL 



BJF - SUBMIT/SPOOL 

SUBMIT [[IN = ]<filespec>] [;<options>] [<profile keyword overrides>] 

SPOOL [[IN = ]<filespec] [;<options>] [<profile keyword overrides>] 
where 


<f ilespec > 


Options: 


names the file containing the request profile; the request profile Is comprised of 
keyword-parameter value pairs. 


DUP - assigns a unique request name if the one specified is already in use; this assign¬ 

ment is done by appending a number to the original request name. 

< profile keyword - are keyword-value pairs to be used instead of those specified in the profile. The 

overrides> following keywords are valid: 


REQNAME= <name> 
CLASS = < class > 
REQFILE= <filespec> 
PRIORITY = <name> 
COPIES = <nnn> 


FORM = <name> 

REQDISP = (RELEASE | KEEP) 
PRTDISP = (KEEP I DELETE) 
AUTO = (YES | NO) 

TYPE= <code> 


REQPASS = < password > 
CHAINOPT = < string > 
EVENT = <name> 
EVPASS = < password > 
EVSTATE= < characters > 
EVCODE= <code> 


CONNECT [;<options>] 


Options: 

LOGMESSG 

RESTART = < option value > 
SETEVENT= < event > 
SETPASSW = < password > 
SETSTATE= < state > 
CONTINUE 

CHKEVENT = < event > 
CHKPASSW = < password > 
CHKSTATE= < state > 
WATEVENT = < event > 
WATPASSW = < password > 
WATSTATE = < state > 


cDecifies that the next line in the CHAIN file contains a message, 
i specifies a value that is placed in the CHAINRST field in the request record. 

- indicates the event to modify. 

- is the password for SETEVENT. 

- sets the event to the specified state. 

- allows a remote abort. 

- specifies the event name to check. 

- is the password for CHKEVENT. 

- names the state that will not cause CHAIN to abort. 

- names the event to wait on. 

- is the password for WATEVENT. 

- names the state to wait for. 


BJF - CONNECT 




CONSOLE [; < options > ] 
Options: 


BJF- CONSOLE 


NOTIMOUT - causes periodic contact with the Central Controller to 
there are 10 minutes of inactivity. 

The following subcommands are accepted by CONSOLE: 


avoid being timed out if 


ADD 

CHANGE 

CHANGE 

CHANGE 

DELETE 

DELETE 

DELETE 

LOG OFF 

RESET 

RESTART 

RESUBMIT 

SCAN 

DATE 

{END | *} 

{HELP | ?} 

SHUTDOWN 

START 

STOP 


- EVENT < event name> 

- EVENT < event name> 


REOIJfVt 0 ^ nam r 10 { <task name> I resource name>} 
cv/ckVt ST equest name > CLASS<class name> 

EVENT<event name> 

R° D ,^ n T ode name> 10 !<task name> | <resource name>) 
Snnc EST ^ reqUeSt name> CLASS < class name> ' 

LOG " ame> 10 (<,ask name> I <resource name>} 


2i2fif!J <reque#t name > CLASS<class 
REQUEST< request name> CLASS< class 
EVENT<event name> 


name> 

name> 


N0DE ! REQUEST] UNSPOOLER 

MENU 

PASSWORD 

T| ME 

- FAST j WAIT 


- NODE<node name> ID{<task name> 

- NODE<node name> ID {<task name> 


| <resource name>} 
| < resource name>} 


The CAT utility is used to display a list of the disk files currently accessible. It can display all the files 
available, all files that match a generic input mask, or a specific file. 

In addition, through the use of the options, status information can be displayed for each file, and the format of 
the display can be altered. 

CAT [[IN = ]<filespec 1 >] [,[OUT = ]<filespec 2> [;<options>] 
where 

[IN = ]<filespec 1 > represents either a single or generic file specifications. 

[OUT = ]<filespec 2> is the output file specification if the PRINT or FILESPEC options are used. 


CAT UTILITY 




A single file specification names one file in the following format: 


CAT-OPTIONS 


<filename>/>ext>:<env> 

A generic file specification names more than one file and is created by using the symbolic replacement 
characters (+, ?, and -) in the name, extension, or environment fields. CAT + / +: + displays all acccessible file 
specifications, for example. 

CAT provides the following options: 

INFO - displays status information on each file as well as file name, extension, and en¬ 

vironment. 

SORT - sorts the output according to file name, extension, or environment. 

PRINT - directs output in print file format to disk or to printer. 

CATALOG - selects and displays catalog names instead of files. 

FILESPEC - causes the name of each file or catalog selected to be written to the output file 

specified by <filespec 2>; do not use this option and the PRINT option at 
the same time. 


CHANGE provides the ability to display and modify the security access information for individual disk files or 
catalogs. 

CHANGE [FILE = ]<filespec> {;<options>} 



CHANGE UTILITY 



CHAREDIT UTILITY 

CHAREDIT, the character set utility;, allows you to generate or modify a character set as an alternative to the 
English character set or to access other language character sets. 

CHAREDIT [<filename>] where 


<filename> is the file specification for the library to be modified (default is CHARFNT/SYS). 


When the following CHAREDIT command is entered, you may select a directive from the following: 


1 INPUT CHARACTER FONT TABLE 

2 INPUT KEY TRANSLATE MEMBER 

3 LIST DATABASE NAME 

4 OVERWRITE CHARACTER FONT TABLE 

5 OVERWRITE KEY TRANSLATE TABLE 

6 EDIT CHARACTER FONT 

7 EDIT KEYIN TRANSLATE TABLE 

8 EDIT 82XX KEYBOARD TRANSLATE TABLE 


9 CREATE CHARLOAD LIBRARY FILE 

10 LOAD KEY TRANSLATE TABLES 

11 DELETE MEMBER FROM DATABASE 

12 ADD CHAR FONT TO DATABASE 

13 ADD TRANSLATE TABLE TO DATABASE 

14 SELECT CHAR FONT FROM DATABASE 

15 SELECT TRANSLATE TBL FROM DATABASE 

16 RETURN TO RMS 


The CHARLOAD command interfaces with the CHAREDIT utility and allows the user to load character fonts 
and keyboard translation tables. 

CHARLOAD [[IN] = <filespec>] [;<options>] 


where 


<filespec> 


is the file specification for the CHARLOAD library file containing the character 
set and key translation table to be loaded. 


CHARLOAD COMMAND 



CONFIG-SYSTEM MODE 


CONFIG operates In two modes-System Mode and Utility Mode. In System Mode, it creates a file containing 
software configuration information that is read when the system is initialized. 

CONFIG [[OUT = ] [<filespec 1 >]] [,[IN = ] [<filespec 2>]] 

[,[NUC = ] [filespec 3>]] [,[WSIN = ] [<filespec 4>]] 

[,[WSOUT = ] [<filespec 5>]] [;<options>] where 

[OUT = ]<filespec 1 > is the System Configuration File (SCF) to be updated. 

[IN = ]<filespec 2> is the provided Subrecord Definitions File (SDF) containing the input to CONFIG. 

[NUC = ]< filespec 3> is a user-created command file which contains the directives CONFIG is to ex¬ 

ecute. 

[WSIN = ]<filespec 4> is a user-created command file which contains the directives CONFIG is to 

execute. 

[WSOUT = ]< filespec 5> is a workstation output file where the messages from CONFIG are written. 


CONFIG provides the following options: 

dcdair - directs CONFIG to recover data from a badly formatted SCF. 


REPAIR 

VERSION 

SYSTEM 


- specifies nucleus and command libraries to be configured. 

- directs CONFIG to run in System Mode. 


CONFIG uses the following directives to complete its tasks: 


INCLUDE 


- causes all nucleus library members to be loaded for possible inclusion in the 
configuration specification. 

- causes all disk supporting nucleus library members to be loaded for possible in¬ 
clusion in configuration. 

- allows the user to select a specific nucleus library member for inclusion in con¬ 
figuration. 

- terminates configuration and causes the new SCF to be created. 

CONFIG-SYSTEM MODE 



CONFIG-UTILITY MODE 


CONFIG in Utility Mode creates or modifies a file containing configuration information read when the member 
corresponding to the configurable utility is initialized. 

CONFIG [[OUT = ] [<filespec 1 >]] [,[IN = ] [<filespec 2>]] [,[WSIN = ] 

[<filespec 3>]] [,[WSOUT = ] [<filespec 4>]] [;<option>] 

where 

[OUT = ]<filespec 1 > is the System Configuration File (SCF) to be updated. 

[IN = ]<filespec 2> is the provided Subrecord Definitions File (SDF) containing the input to CONFIG. 

[WSIN = ]<filespec 3> is a user-created command file which contains the directives CONFIG is to ex¬ 

ecute. 

(WSOUT = )<filespec 4> is a workstation output file where the messages from CONFIG are written. 


CONFIG in Utility Mode 
REDEFINE 
EXIST 
NOEXIST 
UTILITY 


provides the following options: 

- directs CONFIG to ignore any existing data for the specified member. 

- directs CONFIG to terminate if the specified member does not exist. 

- directs CONFIG to terminate if the specified member exists. 

- directs CONFIG to run in Utility Mode. 


CONFIG-UTILITY MODE 



COPY UTILITY 

als C o 0 D P mv1d^thi e r»n! r hT* PrO f !. dupliCate C0PY of a si "9'e file or group of files for backup or distribution. It 
also provides the capability of deleting source files after the copies are performed. 

COPY [IN =]<filespec 1 >,[OUT = ]>filespec 2>[;<options>] 

where 

[IN =]<filespec 1 > either a single file specification or a generic file specification for the file being 
copied. Refer to page 9 for generic replacement symbols. Using + /CMD.+ 
specifies all files in all environments whose extensions are CMD, for example. 

[OUT = ]<filespec 2>is the specification for the output file. 


COPY provides the following options: 


ASIS 

BACKUP 

BYPASS 

CANCEL 

DELETE 

MAYBE 

OVERWRIT 

PROMPT 

SORT 


- retains current disk structure of output file. 

- transfers security information of the input file to the output file. 

- continues processing the next file specification if an output file already exists; 
used with generic copy. 

- terminates processing of COPY if the output file exists. 

- deletes specified input file after COPY completes; file specification may be 
generic. 

- asks what action to take if output file already exists. 

- deletes existing output file and creates new output file with input file parameters. 

- prompts user to verify each COPY before it is performed; for generic copy only. 

- sort output according to file name, extension, and environment; for generic copy 
only. 


COPY-OPTIONS 



CREATE UTILITY 

CREATE allows you to create a file specifying space allocation that reserves contiguous disk space. 
CREATE [[OUT = ]<filespec 1 >],[[LIKE = ]<filespec 2>] [;<options>] 
where 


[OUT = ]<filespec 1> is the file specification for the file to be created. 

[LIKE = ]<filespec 2> is the specification for a file which defines the following parameters: FMT, 
LEN, INIT, INC. 

CREATE provides the following options: 


FMT =< x > 
LEN = <n> 

I NIT = <n> 
INC = <n> 
ABORT 


sets the file format, 
allocates <n> sectors to a file. 

allocates <n> contiguous sectors in the first file segment, 
allocates <n> sectors per segment as required. 

terminates CREATE and deletes the output file if the LEN, INIT, or INC cannot be 
completed. 


CTFORMAT allows you to prepare a cartridge tape for use with the 8800 and to add an IPL f ile to the cartridge 
tape. If no option is specified, CTFORMAT interactively prompts for any desired information. 


CTFORMAT [<filespec>] [;<options>] 
where 

<filespec> 


is the specification for the file containing the IPL block; the file must be a com¬ 
mand library type. 


CTFORMAT has the following two options: 

FORMAT - formats a cartridge tape into two tracks of 256-byte data blocks. 

IPL . writes the user-specified IPL file on the tape. 


CTFORMAT UTILITY 



DCTAPE UTILITY 

DCTAPE allows the transfer of text and binary data (only) between Industry standard magnetic tapes and RMS 
disk. DCTAPE also intializes unlabeled, ANSI labeled, and IBM labeled tapes for use by COBOL programs. 
DCTAPE must be executed using one of four subfunction options. 

The tape intialization subfunction creates labels on magnetic tape. 

DCTAPE [[RES = ]<filespec 1 >];TINIT,LABEL = {A|I|U} [,<options>] 

The tape input subfunction transfers files from magnetic tape to RMS disk. 

DCTAPE [RES = ]<filespec 1 >[,[[LOADFILE = ]<filespec 2>];TIN, 

LABEL = {A|l|U} [,<options>] 

The tape output subfunction transfers files from RMS disk to magnetic tape. 

DCTAPE [RES = ]<filespec 1 >[,[LOADFILE = ]<filespec 2>];TOUT, 

LABLE = {A|l|U} [,<options>] 

The tape examination subfunction analyzes the label of any tape to determine the tape’s structure. 

DCTAPE [RES = ]<filespec 1 >[,[LOADFILE = ]<filespec 2>] 

[,[PRT = ]<filespec 3>];TEXAM [,<options>] 


where 

<filespec 1 > 
<filespec 2> 

<filespec 3> 


specifies the magnetic tape device. 

specifies a library containing any user-assembled translate tables and/or user- 
label processing routines. 

specifies the printer resource or the disk print file. 


DCTAPE UTILITY 



DCTAPE provides the following options; each subfunction (UNIT, TIN, TOUT, TEXAM) haPits^wn HELPoption 
which defines compatible options. 


LABEL ={A|I|U} 

LOAD 

TRL= {719} 

LTRANS= {ASCII 

MODE {CIT} 

DTRANS = {ASCII 

ULAB = <filemember name> 
BPI= <556|800|l600} 
OVERWRIT 
MLTIREEL= <nn> 


- label type A is (ANSI), I (IBM), or U (unlabeled). 

leaves tapes ready on completion. 

specifies 7- or 9-track tape. 

/ EBCDIC / BCD},<file member name> 
specifies the type of label translation. 

T converts 6-bit to 8-bit bytes; C, 8-bit to 6-bit. 

EBCDIC | BCD | BIN},<file member name> 
determines the data translation table to be used. BCD 
may be used only with 7-track types. 

names the user-label processing routine filename. 

verifies the recording density of the tape. 

- overwrites any specified and already existing file. 

- specifies the number of tape reels to be used. 


DELETE provides the ability to delete an unwanted file or group of files from any accessible environment. The 
deleted file is no longer listed in the directory and its disk space is deallocated. 

DELETE [IN = ]<filespec>[;<options>] 

where 

[IN = ]<filespec> is either a single file specification or a generic file specification which limits the 
scope of the files to be deleted. Refer to page 9 for generic replacment symbols. 
Using ABC?/ +: + specifies all 4-character filenames whose first 3 characters are 
ABC, with any extension in any environment, for example. 

DELETE provides the following options: 

PROMPT - asks the user to verify each DELETE before it is performed. 

NOPROMPT - deletes specified files without prompting for verification. 

SORT - sorts according to file name, extension, or environment. 


DELETE UTILITY 



DUMP UTILITY 


DUMP allows the user to interactively display, print, or modify data stored on a specified disk resource. 
DUMP [IN = ] < f ilespec > [,[PRT = ]<printer>];[<options>] 
where 

[IN = ]<filespec> is the RMS file specification of the file being DUMPed. 

[PRT = ]<printer> is the device specification of the printer to which hardcopy ouput is directed. 
DUMP provides the following options: 

RES - states that the <filespec> is the RMS resource name of the disk. 

WRITE - allows the user to modify the file being displayed. 


EDIT allows the user to create and modify text files. 

EDIT [IN = ]< filespec 1 >[,[OUT = ]< filespec 2 >] 

[,[WORK = ]<filespec 3>] [;<options>] 

where 

[IN = ]cfilespec 1 > is the specification for the input file to be created or modified. 

[OUT = ]<filespec 2> is the specification for the ouput file where the updated file is stored when EDIT 

is terminated. 

[WORK = ]<filespec 3> is the specification for the scratch file. 

EDIT provides the following options: 

CREATE - creates the specified input file. 

NOCOMP - causes uncompressed records to be written. 

READ - allows the input file to be opened in read only mode. 

The EDIT command allows modification of text through directives (special characters) that are entered from 
the keyboard. 


EDIT UTILITY 



ENCODE UTILITY 

The ENCODE utility converts disk files containing any type of data into text files suitable for transmission by a 
data communications program. The ENCODE utility also has a DEC (decode) capability to restore the encoded 
data to its original form. 

ENCODE [IN = ]<filespec 1 >[,OUT = ]<filespec 2>] [;<options>] 
where 

[IN = ]<filespec 1 > is the file being encoded or decoded. The filename must be provided. 

[OUT = ]<filespec 2>is the file resulting from the encoding or decoding operation. 

ENCODE provides the following options: 

DEC - determines that decoding will be performed. 

ENC - determines that encoding will be performed. 

CONV - converts binary data to 6-bit ASCII. With DEC, it restores data in an encoded 

6-bit file to original form. 

KEY - encodes or decodes file. 


ENV is used to create, delete, and modify additional environments to control a user’s scope of access to the 
system. ENV also allows mapping the hierarchical structure of the disk and system backup. 

ENV [[ENV = ]:<envname 1 >] [.[AFTER = ]:<envname 2> [,[PRT = ]<filespec 1 >] 

[,[WORD = ]< filespec 2 >] [,[BKENV = ]: <envname 3>[ [,[BKCHN = ]< filespec 3>] 

[;< options >] 


where 

[ENV = ]: < envname 1 > 
[AFTER = ]:< envname 2> 
[PRT = ]<filespec 1 > 
[WORK = ]<filespec 2> 
[BKENV = ]<envname 3> 
[BKCHN = ]<filespec 3> 


names the environment to be created, modified, deleted, or displayed. 

is used to position <envname 1 >. 

specifies the print file to be used for MAP option. 

specifies the work file for the MAP option. 

specifies the backup environment for the BACKUP option. 

is the output CHAIN file created by the BACKUP option. 


ENV UTILITY 



ENV-OPTIONS 


ENV provides the following options for environment control: 


CREATE 

DELETE 

INSERT 

REMOVE 

MODIFY 

PASS 

MAP 

BACKUP 

FORCE 

ID 


- adds entry to UET for <envname> and creates catalog file. 

- deletes environment and catalog file. 

- adds environment to UET for existing catalog file. 

- removes environment from UET. 

- changes the passwords for an environment. 

- displays environments and passwords. 

- maps hierarchical structure of disk. 

- initiates a backup of all files within and subordinate to a catalog. 

- inserts an entry in the UET even if the resource to be accessed does not exist in 
the system. 

- changes the description of a catalog. 


The Error Recording and Reporting (ERRLOG) utility allows you to log hardware failures of disk and com¬ 
munications I/O devices. A report summarizing the logged information may be generated through the ERREPORT 
utility. 

ERRLOG [[LOG = ]<filespec 1> [,[WSIN =]<filespec 2>) 

[,[WSOUT = ]<filespec 3] [;<options>] 


where 

[LOG = ]<filespec 1 > is the specification for the Error Logging File (ELF) which is used to record hard¬ 

ware failure information. 

[WSIN = ]<filespec 2> is a file the user may create to contain ERRLOG directives. 

[WSOUT = ]<filespec 3> specifies a file to contain all messages returned during ERRLOG. 


ERRLOG UTILITY 



ERRLOG UTILITY 

ERRLOG provides the following options which can be specified on the command line or chosen from a main 
menu: 

RES[ = ALL|< resource name> - specifies the resources which will be logged for errors. 

CONT[ = ALL|<controller ID> - specifies the controllers which will be logged for errors. 

8800 [ = ALL|<8800 node num>] - specifies the 8800 nodes that will be logged for memory errors. 

START - starts the error logging task. 

STATUS - displays the error logging status. 

STOP - terminates the error logging task. 


The RMS Error Report utility (ERREPORT) generates a report of the RMS error log, displaying the 
following information: 

1) System start time (IPL) 

2) Resource name or controller ID 

3) Net and node name 

4) Communicating drive ID and error threshold 

5) Logical port number (controllers only) 

ERREPORT [[IN = ]<filespec 1>] [,[OUT = ]<filespec 2>] [;<options>] 
where 

[IN = ]<filespec 1 > specifies the error log input file. 

[OUT = ]<filespec 2>specifies the error report output file. 

ERREPORT offers the following options: 

NOSORT - assumes input file is pre-sorted. 

SELECT - after sorting, allows selected data to be printed. 

AVG - accumulates total activity and computes the hourly activity average. 

ERREPORT 



FMS UTILITIES 

The File Management System (FMS) utilities enhance system throughput by providing managed file I/O access 
as well as standard file access capabilities. FMS is made up of the following components: 


FAR 

MANAGE 

CONFGFMT 

FMTCONT 


File Access Routines (FAR) make up a library of routines for I/O processing. 
These routines are either executed by FMS or called by user programs. 

creates or updates for each file to be managed a unique Managed File Descrip¬ 
tion (MFD) containing information about the file. 

creates or updates a unique FMS configuration file for each File Management 
Task (FMT) to be executed. 

initializes and terminates an FMT. 


The MANAGE utility interactively creates or edits the unique Managed File Descriptor (MFD) that must exist 
for each file to be managed by FMS. Four out of five possible screens, depending on whether the file to be 
managed is DIRECT or ISAM, prompt the user for file description, FMT directory information, and FMT descrip¬ 
tion. 

MANAGE < f ilespec > [; < options > ] 
where 


<?ilename> is the file specification of the MFD to be created or modified. 

The following option is available for MANAGE: 

CREATE - directs MANAGE to create the specified file as a new MFD. 


MANAGE UTILITY 



CONFGFMT UTILITY 


The CONFGFMT utility creates or modifies a configuration file for a given FMT. A configuration file must be 
created for each FMT to be executed, parameters are defined according to the responses supplied to prompts 
displayed through a series of interactive screens. 

CONFGFMT [<filespec>] [;<options>] 

where 


<filespec> is the output file created or modified by this utility containing the configuration 

information for an FMT. 


CONFGFMT has one option: 

CREATE - creates a new FMT configuration file. 


The FMTCONT utility initializes or terminates an FMT. While initialized, the FMT performs the actual user file 
access and buffer management for a given file. 

FMTCONT [<filespec>] [;<options>] 

where 

<filespec> specifies a configuration file created by the CONFGFMT utility. 

FMTCONT offers the following options: 

DIE - terminates the FMT after all users have logged off. 

ABORT - directs the FMT to disregard all logged-on users and to terminate immediately. 

DEBUG = <wsname> specifies an available resource name whose device type must be a workstation; 

the standard RMS debug display appears on the screen of this station. 

FMTCONT UTILITY 
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GETARC UTILITY 

The GETARC utility allows you to transfer files from a DOS ARC file processor to an RMS disk, providing an inter¬ 
face between the two operating systems. GETARC cannot transfer files from a local disk. (See GETDOS for local 
disk capabilities.) 

GETARC [IN = ]<filespec 1 >[,[OUT = ]<filespec 2>] [;<options>] 
where 

[IN = ]<filespec 1> is the name and extension of the DOS ARC file to be copied; this file must be 
specified. 

[OUT = ]<filespec 2>is the file specification of the RMS output file. 

The following options are available using GETARC: 


BIN 

- specifies a binary type transfer. 

VOL = 

- specifies the DOS ARC value identification, 

NAME = 

- specifies the DOS ARC user name. 

CODEWORD= 

- specifies the DOS ARC user codeword 


MEMBER = 

- is the DOS ARC library member name; the DOS library name must be specified 
as <filespec 1 > with this option. 

NET = 

- is the RMS network name to which the output file is directed. 

DOSVER = < n> 

- is the DOS version being used. 

ARCVER = <n> 

- is the ARC version being used. 

DOSREL= <n> 

- is the DOS release being used. 

ARCREL= <n> 

- is the ARC release being used. 
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GETDOS UTILITY 

GETDOS reads files from a DOS formatted disk and writes them to an RMS formatted disk. 

GETDOS [IN = ]<filespec 1 >[,[OUT = ]<filespec 2>] [;<options>] 
where 


[IN = ]<filespec 1 > is the name and extension of the DOS file to be copied. The name must be 
specified. 

[OUT = ]<filespec 2>is the file specification of the RMS output file. 

GETDOS provides the following options: 

• specifies a binary transfer type. 

- is the DOS volume name. 

• names the DOS subdirectory of the input file. 

- length of the output file. 

• file increment of the output file. 

- specifies that the records of the output file will be written uncompressed. 

- specifies a DOS library member name (<filespec 1> must specify the DOS 
library name). 

- specifies a fixed length record size. 


BIN 
VOL = 

SUR = 

LEN = 

INC = 
NOCOMP 
MEMBER = 

RECSIZE 


INDEX creates or reorganizes an index file to provide ISAM access to the records of a text file. 

INDEX [IN = ]<filespec 1> 

[,[OUT = ]<filespec 2>] 

[,[PRT = ]<filespec 3>] 

[,[WK1 = ]<filespec 4>] 

[,[WK2 = ]<filespec 5>j 
[,[SEQ = ]<filespec 6>] 

[,[TAG = ]<filespec 7>j 
[,[SRC = ]<filespec 8>j 
[;<option 1 >] [,<option 2>] 

where the exact order of the file specifications varies depending on the function 
selected on the command line. 


INDEX UTILITY 



INDEX UTILITY 

INDEX provides options to select the function desired and to provide parameters for the selected function: 


Select Function 


Provide Parameters 


No option 
I 

X 

INFO 

ENVMOD 

KTAGDEL 


- use data file 

- use tag file 

- reorganize 

- display header 

- modify env mask 

- delete tag file when 

task over 


LF= <nn> 

SPB = <n> 

KPB = <n> 

D 

S = “<sort options>” 


M = <n> 


- loading factor 

- sectors per block 

- records per block 

- duplicate keys allowed 

- identifies fields in the 
data file to be used 
as a sort key. 

- maximum record length. 


The INFO utility provides the user with system status information on system resources. No file specifications are 
required. If no options are specified, resources available through the UET are displayed on a scrolling screen. 


INFO [;[<option 1 >] [,<option 2>] . . .] 
Option 1: 


RES 

DISK 

TASKS 

CONNECTS 

LINKS 

UTIL 

Option 2: 

NET = <a> 
NODE = <a> 
ENV = <a> 
ALL 

SUMMARY 


- displays status information for non-disk resources only. 

- displays status information for disk resources only. 

- displays status information for executing tasks only. 

- displays status information for nodes only. 

- displays status information for Resource Connection Links. 

- displays resource utilization for the local node only. 


- includes information from all networks or a specified net. 

- includes information on all nodes or a specified node. 

- display items in specified environment. 

- display information for all nets & nodes found in all environments accessible to 

local node. 

- provide a summary of the number of RES, DISKS, TASKS, CONNECTS, and 
LINKS displayed. 

INFO UTILITY 



The LIB utility is used to create and maintain command libraries. 


LIB UTILITY 


LIB [OUT = ]<filespec 1 >[,[WRK = ]<filespec 2>] [,[WSIN = ] 
<filespec 3>] [,[WSOUT = ]<filespec 4>] [,[options>] 


where 

[OUT = ]<filespec 1 >] 
[WRK = ]<filespec 2>] 
[WSIN =]<filespec 3>] 

[WSOUT = ]<filespec 4> 

LIB has one option; 
CREATE 


is the library that is created, modified, or accessed. 

is the temporary work file used by the CLEANUP directive. 

is the specification for a user-created file containing LIB directives; otherwise, 
directives are entered at the workstation. 

is the specification for a file to receive all messages returned during LIB; other¬ 
wise, messages are displayed at the workstation. 


- creates a new output library. 


LIB directives provide the following capabilities: 


ADD 

REPLACE 

EXTRACT 

DELETE 

RENAME 

MERGE 

ENTRY 


manipulates or renames library members. 


designates the first member of a library. 


OPEN 


specifies a new output library. 


GENERATE 


creates a member that contains all external definitions from relocatable 
members in the current library. 


CAT 

CLEANUP 
{END | *} 
CREATE 
SIGNON 


lists all members in the library. 

recovers space lost by DELETES and REPLACES. 

terminates LIB execution. 

creates a new output library. 

allows the sign-on message to be modified. 


LIB-DIRECTIVES 



LINK UTILITY 

LINK manipulates and transforms relocatable members of libraries into either absolute or relocatable 
members of a LINK output library. 

LINK [[[CMD = ]<filespec 1 >] [,[OUT = ]<filespec 2>] [,[PRT = ]<prntfile>] 

[,[ENV = ]<env>] [;<options>] 


where 


<filespec 1 > 
<filespec 2> 

<filespec 3> 
<env> 


is the optional input file of LINK directives. 

is the output library into which any absolute members generated by LINK are 
added. 

is the print file produced by the PRNT or Q options, 
is the environment for the LINK work file. 


LINK provides the following options: 


ABBREV 

DISP 

ERR 


- asks for abbreviated symbol table or cross-reference list. 

- generates and displays loader table listing on screen. 

■ indicates that the object file is not to be opened and LINK is to be terminated 
if any errors are encountered. 


PRNT 

Q 

REL 

SYMB 

TABLE 

UREL 

fXREF 

NEW 

FASTLIB 


- produces print file. 

- instructs LINK to queue the LINK print file. 

- generates relocatable code. 

- alphabetically sorts, then prints external symbol table entries. 

- directs symbol table printing in tabular form. 

- generates relocatable output that can be loaded and executed. 

- produces sorted cross-reference list of symbol table. 

- overwrites the old library with the new library. 

LINK-OPTIONS 

. - provides an alternative library search scheme. 



LIST UTILITY 

The LIST utility provides the capability to transfer files from one resource to another to display files, and to for¬ 
mat the files for printed output. 

LIST [[IN = ]<filespec 1 >] [,[OUT = ]<filespec 2>] 

[,[VFUCMNDS = ]<filespec 3>] [;<options>] 

where 

[IN = ]<filespec 1> is the name of the file to be listed. 

[OUT = ]<filespec 2> is the specification for the output device or for the formatted output file. 

[VFUCMNDS = ]< filespec 3> specifies the text file containing VFU directives used with the VFU option only. 


List offers the following options: 


FORM 

LREC = <n> 
COL 

LPP = <n> 

QUEUE 

VFU 

SYSPARM 
WRAPLN = <n> 
LSEC = <n> 
MAXREC = <n> 
WRAP 
ISAM 
NONBR 
PRINT 


- formats input file. 

- starts at record n. 

- displays output with column headings. 

- changes page length to <n> lines. 

- creates formatted file for output and append to existing file. 

- changes forms control information before LISTing to a printer or a print file. 

- controls channel advancing with the VFU option. 

- specifies the maximum length of an output line when WRAP is used. 

- starts list with the second logical record in the specified sector. 

- states maximum input record size in K bytes, where n is 1, 2, 3, or 4. 

- wraps to next line; the default line length is 110. 

- lists on ISAM file. 

- suppresses line numbers. 

- creates print file. 


LIST-OPTIONS 



LOG UTILITY 


The LOG utility provides a job trace capability logging all informational and error messages displayed at a 
workstation screen for the duration of the log. This log file is helpful to keep record of job completions and times, 
and to help analyze errors. 

LOG [[OUT = ]<filespeo] [;<options>] 

where 


[OUT = ]<filespeo is the file specified to receive the logged output. 


The LOG utility offers the following options: 


ON - activates logging 

OFF - terminates logging. 

QUEUE * appends output to a log file. 

PRINT - sends log information to a local printer. 


ERROR - logs error messages. 
ALL - logs all messages. 

SUSPEND - suspends logging. 
RESTART - restarts logging. 


The MINIDOS utilities, MINIDISK and MINIARC, allow an RMS user to simulate a DOS ARC file processor on an 
RMS node, enabling RMS users to benefit from some DOS software features not available under RMS. 

MINIDISK [OUT = ]< filespeo [;< options >] 

where 

[OUT = ]<filespeo names the RMS file created (or extended) to contain the DOS pseudo-volume. 

MINIDISK options are: 

SEC = <n> - specifies the number of RMS sectors to create. 

EXT = <n> - specifies the number of RMS sectors by which to extend the filesize. 

MINIARC [[CNFG = ]<filespeo] [;<options>] 

where 

[CNFG = ]<filespeo is the configuration file containing information needed to establish the DOS 

volume; if this file is not available, MINIARC prompts for the needed data. 

MINIDOS UTILITIES 



NQDQ UTILITY 

The Enqueue/Dequeue (NQDQ) utility allows the local operator to activate this access-handling system for use 
by user programs. 

NQDQINIT [<filespec 1>] [[LOG = ]<filespec 2>] [;<options>] 
where 

<filespec 1 > is the configuration file containing configuration data for the NQDQ system. 

[LOG = ]<filespec 2> specifies the log file if the LOG option is used. 

NQDQ provides the following options: 

CMD = S - starts the NQDQ session. 

CMD = T - terminates the NQDQ session. 

LOG - generates a log file of NQDQ activity for debugging. 

LOGSIZE - specifies in sectors the size of the log file. 


The PACKGEN utility allows the user to initialize disk for use under RMS. Initialization includes verifying sec¬ 
tors, generating system tables, and formatting soft-sectored disks. 

PACKGEN <resource name>[<filespec>];<option> 


where 

< resource > 
<filespec> 


is the resource name of the pack being initialized. 

is the Initial Program Load (IPL) file specification, if a special IPL is needed, 
that corresponds to the type of disk being generated. 


PACKGEN offers the following options: 


IPL 

RES 

GEN 


- to write only the IPL blocks. 

- to write only the resource name. 

- for a complete pack generation. 


PACKGEN UTILITY 



PCR UTILITY 

The PCR utility allows you to access and modify selected entries in the Program Communications Region 
(PCR) in support of local requirements and conditions. 

PCR [;< options >] 

No file specifications are required. All current PCR information is displayed if none of the following options are 
specified. 

AVAIL - returns number of bytes of available PCR memory. 

FORMLGT = <nnn> - allows you to assign a value for form length. 

HEADING = {ONIALLIOFF} - determines display of heading line. 

MAXMEM = <nnn> - resets maximum task memory limit in the PCR to <nnn>K bytes. 

MINMEM= <nnn> - reserves <nnn>K bytes of minimum task memory. 

PRIORITY = <n> - allows you to set priority of task. 

RESERVE = <nnnn> - reserves specified number of bytes of PCR memory. 

TIME = {SETIADJUSTlBOTH > - sets or adjusts time and date (or both). 


The PUTARC utility allows you to transfer files from an RMS disk to a DOS ARC file processor providing an In¬ 
terface between the two operating systems. PUTARC cannot transfer RMS files from a local disk (see PUTDOS 
for local disk capabilities.) 

PUTARC [IN = ]cfilespec 1 >[,[OUT = ]<filespec 2>] [;<options>] 
where 

<filespec 1 > is the file specification of the RMS file to be copied. 

<filespec 2> is the name and extension of the DOS output file. 

The following options are available using PUTARC: 

specifies a binary transfer type, 
specifies the DOS ARC volume identification, 
specifies the DOS ARC user name, 
specifies the DOS ARC user codeword, 
is the RMS network name to which the output file is directed, 
is the DOS version being used, 
is the ARC version being used, 
is the DOS release being used, 
is the ARC release being used. 


BIN 
VOL = 

NAME = 
CODEWORD= 
NET = 

DOSVER = <n> 
ARCVER= <n> 
DOSREL= <n> 
ARCREL= <n> 
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PUTDOS UTILITY 

PUTDOS provides the capability to copy RMS formatted text files to a DOS formatted disk. 

PUTDOS [IN = ]<filespec 1 >[,[OUT]<filespec 2> [;<options>] 
where 

[IN = ]<filespec 1 > is the RMS text file specification. 

[OUT = ]<filespec 2> is the DOS text file specification. 

PUTDOS offers the following options: 

SUR= <DOS subdirectory> - used to select the subdirectory for the output file. 

VOL= <DOS volid> - allows the user to specify the DOS volume to receive the data. 

BIN - copies the RMS file to DOS sector by sector, overwriting the first three bytes 

of each sector with the DOS sector verification PFN and LRN. 


The REFORMAT command allows the user to alter the format of RMS text files and to modify the structure of 
records within a text file. 

REFORMAT [[IN =]<filespec 1 >],[OUT = ]<filespec 2> 

[,[WSIN = ]<filespec 3>] [,[WSOUT = ]<filespec 4>] [;<options>] 


where 

[IN = ]<filespec 1 > 

[OUT = ]<filespec 2> 
[WSIN = ]<filespec 3> 

[WSOUT = ]<filespec 4> 


is the text file to be reformatted. 

is the output file to be created by REFORMAT. 

names a user-created source file containing REFORMAT directives. If no file is 
specified, REFORMAT defaults to the workstation. 

names the destination file for all REFORMAT messages; otherwise, messages 
are shown at the workstation. 


REFORMAT UTILITY 



REFORMAT-OPTIONS 


REFORMAT provides the following options: 


NOCOMP 
LEN = <n> 

TRUN 

SEG 

FIX 

MAXREC = <n> 


- specifies that the output file is not to be space compressed. 

- allows the user to specify the length of each logical record in number of bytes 

(n). 

- is used with the LEN option to specify that any logical record longer than n 
bytes will be truncated. 

- is used with the LEN option to specify that any logical record longer than n 
bytes will be divided into two or more records. 

- is used to enter FIX mode; this option must be specified before the user can 
execute the REPLACE, INSERT, and DELETE interactive directives. 

- indicates that the largest record size in the file exceeds 256 bytes; < n > must 
be 1,2,3, or 4, representing 1 to 4 multiples of 1024 bytes (IK). 


Along with the options listed above REFORMAT uses the following directives to complete its tasks. Interactive 
mode is entered only if no input file is specified on the command line. 

Not in FIX Mode In FIX Mode 


OPEN<filespec> 

COPY( < column >, < length >) 

INCLUDE 

EXCLUDE 

IF<expression>< logical operator> 
< expression >...THEN 
XIF 
GO 

END | * 


OPEN<filespec> 

REPLACE( < column >, < length >)“ < string > ” 
INSERT( < column >, < length > “ < string > ” 
DELETE(< column >< length >) 

IF<expression><logical operator> 

< expression > ...THEN 
XIF 
GO 

END I * 
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RENAME UTILITY 

The RENAME utility allows you to assign a new name, extension, or environment to an existing file. 
RENAME [IN = ]<filespec 1 >,[OUT = ]<filespec 2>[;<options>] 
where 

[IN = ] < filespec 1 > is a single or generic file specification for the file being renamed. A generic file 

specification may contain the symbolic replacement characters. 


[OUT = ]<filespec 2> is the new file specification for the file. 

RENAME provides the following options: 

BYPASS - file protect options which specify the action that the RENAME utility should 

CANCEL ' take if the output file already exists. 

PROMPT 


SORT = <aaa> 


- alphabetizes the displayable output according to the filename (F), extension 
(X) or environment (E). Any combination of FXE can be specified or <aaa>. 


The REPAIR utility is a highly interactive utility that can be used to check and correct errors on disk resources. 
As REPAIR is executed, it prompts for instructions. 

REPAIR < resource > [; < options > ] 

where 


< resource> names the disk resource to be REPAIRed. 

REPAIR has one option: 

OVERFLOW - handles REPAIR’S additional memory requirements when REPAIR is running 

on a 128K single drive system or an 8600 processor only. Caution: This option 
can cause files on the disk resource to be destroyed. 


REPAIR UTILITY 



SECURE UTILITY 

The SECURE utility allows the user to change the following security parameters of any RMS file: 

• File access code • Password names 

• File sector allocation size • Security level 

SECURE [[IN = ]<filespec>] [;<options>] 
where 

[IN = ]<filespec> is the input file specification. For selecting a generic file specifications, use 

the format: 

<generic filename>/<generic ext>:<specific env> 

A specific environment must be provided on the command line or an error will 
result. 

SECURE provides the following option: 

PROMPT * prompts for verification that security processing is to occur. 


The following directives may be entered via the SECURE Utility: |7 g^e * /%& ft/ 




SET < Password Reference>; <Acc Bits> 

ADD < Password Reference>; <Acc Bits > 
REM(ove) < Password Reference> [;<Acc Bits>] 
CRE(ate) < Password Reference> [;<Acc Bits>] 
DEL(ete) < Password Reference > 

REN(ame) <Password Reference> {Password} 
SEC(urity) <Secr Level > 

IAC [<Acc Bits>] 

FINC < Sector Ct> 

{HELP | ?} - displays menu of directives. 

{END | *} - begins processing any directive entered. 
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SORT UTILITY 

The SORT utility allows the user to sort a text file according to any specified collating sequence. 

SORT [IN = ]<filespec 1 >,[OUT = ]<filespec 2>[,[WORK = ]< filespec 3>] 

[,[SEQ = ]<filespec 4>] [;<options>] 


where 

[IN = ]< filespec 1> 
[OUT = ]< filespec 2> 
[WORK = ]<filespec 3> 
[SEQ = ]<filespec 4> 


is the input file specification, 
is the output file specification, 
is the work file used by SORT, 
is the file containing an alternate 


SORT provides the following options: 


A 

D 

C 


sorts in ascending order, 
sorts in descending order, 
sets compression on. 


collating sequence. 


(Continuation of SORT options) 
N 


M<nnn> 

Q 

P<nnnn> = <a> 
P<nnnn>#<a> 
S<nnnn> = <a> 
S<nnnn>#<a> 


B 

K 

L 

T 


<nnnn>-<nnnn> 

X 

Ennnnnnnn 

U 

Fnnnnnnnn 

V 


- sets compression off. 

- biocks to 1 record/sector. 

- specifies maximum input record length. 

- makes SORT faster. 

- sorts primary record containing <a> in column <n>. 

- sorts primary record not containing <1a> in column <n>. 

- sorts secondary record containing <a> in column <n>. 

- sorts secondary record not containing <a> in column <n>. 

- specifies binary tag format. 

- specifies key tag format. 

- output records limited to certain input columns/record. 

- specifies ASCII decimal tag format. 

- specifies sort key by column number. 

- writes record count as the first record. 

- specifies sectors to allocated output file. 

• determines sectors allocatd to the output file. 

- allocates sectors to work file. 

- determines sectors allocatd to the work file. 
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STARTUP UTILITY 

The STARTUP utility provides the capability to store the user’s current UET data in a file that can later be used to 
support automatic long-on or that can be loaded during a work session to restore the UET. Command lines to be 
executed can also be stored in this startup file. STARTUP runs in create mode or load mode, whose correspon¬ 
ding command lines are: 

STARTUP [[OUT = ]< filespec >];CREATE[, < options>] 
or 

STARTUP [[IN = ]<filespec>] [;<options>] 
where 

[OUT = ]<filespec> is the file created to store UET data. 

[IN = ]<filespec> specifies the file to be used to load UET data. 

STARTUP provides the following options: 


CREATE 

NORUN 

FORCE 

DISP 

NOCHECK 

NOERR 


- allows creation of a startup file. 

- suppresses execution of any stored command line during load mode. 

- inserts UET entries whether or not the corresponding catalogs can be opened. 

- displays UET entries (except passwords) as they are inserted during local mode. 

- does not check to see if an environment can be accessed before it is inserted in the UET. 

- suppresses the display of UET data during load mode; overrides the DISP option. 


The TAPEUTIL utilty allows the user to transfer any type of RMS disk data files to or from an -- 

magnetic tape, or 3M cartridge. ° CM##W » 

TAPEUTIL [[IN = ] < f ilespec 1 >],[VOL = ]< volume > 

[,[RES = ]< resource>][,[PRT = ]< filespec 2> [; <options>] 


where 

[IN = ]<filespec 1 > - is the specification for the file to be transferred. 

[VOL = ]<volume> - is the name of the tape containing the file to be transferred. 

[RES = ]<resource> , ,- is the name of the resource you will use to read from • 
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